๐๏ธGitะฏัะฐ๐๏ธ
docs/zh-rTW/user/telemetry-and-sensors.md 2d20cd8a4708e2ef66e98d5259f3a97ec93f240a (2d20cd8a) Text, 6.60 KB
title: Telemetry & Sensors
parent: User Guide
nav_order: 9
last_updated: 2026-05-13
description: Sensor data on the mesh โ supported environment, air quality, and power sensors, plus configuration and viewing guides.
aliases:
โข sensors
โข environment
โข weather
โข power-metrics
Telemetry & Sensors
Meshtastic nodes can collect and share sensor data across the mesh network.
ๆฆ่ง
Telemetry allows nodes equipped with sensors to broadcast environmental, power, and device health information. This data is visible on the node detail screen and can be logged over time.
่ฃ็ฝฎ้ๆธฌ
All Meshtastic nodes report basic device telemetry:
โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ๏ผๅ
ฌ้/ๅ
ฌๅฐบ๏ผ โ ๆ่ฟฐ่ชชๆ โ Typical Range โ
โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโค
โ Battery Level โ Charge percentage โ 0โ100% โ
โ ้ปๅฃ โ Battery voltage โ 3.0โ4.2V (LiPo) โ
โ ้ ป้ไฝฟ็จ้ โ % of airtime used locally โ 0โ100% โ
โ Air Utilization TX โ % of airtime used by this node โ 0โ100% โ
โ ้่กๆ้ โ Seconds since last boot โ Varies โ
โโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
Environment Sensors
Supported environmental sensors:
Temperature & Humidity
โโโโโโโโโโโฌโโโโโโโฌโโโโโโโฌโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆๆธฌๅจ โ ๆบซๅบฆ โ ๆฟๅบฆ โ ๆฐฃๅฃ โ ๅ่จป โ
โโโโโโโโโโโผโโโโโโโผโโโโโโโผโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ BME280 โ โ โ โ โ โ โ Recommended all-in-one โ
โ BME680 โ โ โ โ โ โ โ Adds gas resistance/IAQ โ
โ SHT31 โ โ โ โ โ โ โ High accuracy โ
โ MCP9808 โ โ โ โ โ โ โ Precision temperature โ
โ LPS22 โ โ โ โ โ โ โ Pressure only โ
โโโโโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโ
Air Quality
โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆๆธฌๅจ โ ๅ
ฌๅถ๏ผๅ
ฌ้/ๅ
ฌๅฐบ๏ผ โ ๅ่จป โ
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ BME680 โ Gas Resistance / IAQ โ Volatile organic compounds โ
โ PMSA003I โ PM1.0, PM2.5, PM10 โ Particulate matter โ
โ SEN55 โ PM, NOx, VOC, Temp, Humidity โ Multi-sensor โ
โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Light & UV
โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโ
โ ๆๆธฌๅจ โ ๅ
ฌๅถ๏ผๅ
ฌ้/ๅ
ฌๅฐบ๏ผ โ
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโค
โ OPT3001 โ Ambient light (lux) โ
โ VEML7700 โ Ambient light (lux) โ
โ LTR390 โ UV index โ
โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโ
้ปๆบ่จ้่ณๆ
Nodes with INA-series power sensors can report:
โโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ๏ผๅ
ฌ้/ๅ
ฌๅฐบ๏ผ โ ๆ่ฟฐ่ชชๆ โ
โโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Bus Voltage โ Supply rail voltage โ
โ ็ฎๅ โ Power consumption (mA) โ
โ ้ปๅ โ Calculated power (mW) โ
โโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโ
Useful for monitoring solar charging or battery health on remote nodes.
Configuring Telemetry
1. Navigate to Settings โ Module Config โ Telemetry.
2. Set reporting intervals:
โข Device Metrics Interval โ how often to broadcast device metrics
โข Environment Metrics Interval โ how often to broadcast sensor data
3. Enable specific sensor types as needed.
Recommended Intervals
โโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
โ Use Case โ Device (s) โ Environment (s) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโค
โ Urban mesh (many nodes) โ 3600 โ 3600 โ
โ Rural mesh (few nodes) โ 900 โ 900 โ
โ Weather station โ 900 โ 300 โ
โ Battery conservation โ 7200 โ 7200 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
โ โ ๏ธ Note: Shorter intervals increase airtime usage and battery drain across the mesh.
Air Quality Metrics
Nodes with particulate matter or COโ sensors report air quality data:
โโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ
ฌๅถ๏ผๅ
ฌ้/ๅ
ฌๅฐบ๏ผ โ ๅฎไฝ โ ๆ่ฟฐ่ชชๆ โ
โโโโโโโโโโโโโโโโโโโโโผโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ PM1.0 โ ยตg/mยณ โ Ultrafine particulate matter โ
โ PM2.5 โ ยตg/mยณ โ Fine particulate matter โ
โ PM10 โ ยตg/mยณ โ Coarse particulate matter โ
โ COโ โ ppm โ Carbon dioxide concentration โ
โโโโโโโโโโโโโโโโโโโโโดโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
COโ sensors such as the SCD4x also report their own temperature and humidity, which appear alongside the readings above. From PM2.5 history the app additionally derives an EPA NowCast AQI value.
The COโ reading is color-coded by severity (Good โ Stuffy โ Poor โ Unsafe โ Evacuate). See Node Metrics โ Air Quality for the exact ppm bands, colors, and AQI detail.
Air quality data can be viewed as info cards on the node detail screen, charted over time, and exported to CSV.
Viewing Telemetry
1. Navigate to Nodes and select a node.
2. Telemetry sections show on the detail screen:
โข Device Metrics (always available)
โข Environment Metrics (if sensors present)
โข Power Metrics (if INA sensor present)
โข Air Quality Metrics (if PM/COโ sensor present)
3. Historical graphs show trends over time.
ๆ
้ๆ้ค
โข No environment data showing? The remote node needs a physical sensor connected (e.g., BME280 on I2C). Device telemetry (battery, uptime) is always available, but environment metrics require hardware.
โข Stale readings? Check the reporting interval โ very long intervals (7200s+) mean data updates infrequently. Also verify the remote node is still online.
โข Sensor conflict on I2C bus? Some sensors share I2C addresses. If you have multiple sensors on the same bus, check for address collisions in the radio's serial debug output.
Related Topics
โข Node Metrics โ view telemetry data on the node detail screen
โข Settings โ Modules & Admin โ telemetry module configuration
โข Units & Locale โ temperature and pressure display units
Served by rngit 1.5.2 - Generated in 0.05s